home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #14 / Monster Media No. 14 (April 1996) (Monster Media, Inc.).ISO / bbs_door / kspslp34.zip / KSP-SLIP.DOC < prev    next >
Text File  |  1996-02-20  |  63KB  |  1,801 lines
  1.  
  2.  
  3.         
  4.  
  5.  
  6.                                   KSP SLIP (tm)
  7.  
  8.                      A SLIP Door for Bulletin Board Systems
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                                    Version 3.4
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.                               Copyright (C) 1995-96
  31.                                All Rights Reserved
  32.  
  33.  
  34.                                        by
  35.  
  36.  
  37.                               KEY SOFTWARE PRODUCTS
  38.  
  39.                                 440 Ninth Avenue
  40.                         Menlo Park, California 94025-1802
  41.                               BBS/FAX: 415-364-9847
  42.  
  43.  
  44.  
  45.                 KSP SLIP is a trademark of Key Software Products.
  46.                  PCL4C is a trademark of MarshallSoft Computing.
  47.                      WATTCP is a trademark of Erick Engelke.
  48.                      Power C is a trademark of Mix Software.
  49.                      Multi-C is a trademark of Mix Software.
  50.              DESQview is a trademark of Quarterdeck Office Systems.
  51.                    Lantastic is a trademark of Artisoft, Inc.
  52.                       Novell is a trademark of Novell Corp.
  53.                    Banyan Vines is a trademark of Banyan Inc.
  54.  
  55.  
  56.  
  57.  
  58.         
  59.  
  60.  
  61.                                 TABLE OF CONTENTS
  62.  
  63.  
  64.  
  65.         CHAPTER 1 - INTRODUCTION        ...........................    1
  66.            1.1  Compatibility with BBS Software     ...............    2
  67.            1.2  Hardware Requirements       .......................    2
  68.            1.3  Software Requirements       .......................    2
  69.            1.4  Other KSP Software      ...........................    3
  70.               1.4.1  KSP Telnet       .............................    3
  71.               1.4.2  KSP FTP       ................................    3
  72.               1.4.3  KSP Mail       ...............................    3
  73.               1.4.4  KSP HOST       ...............................    3
  74.               1.4.5  So Many CD's      ............................    4
  75.  
  76.         CHAPTER 2 - INSTALLATION        ...........................    5
  77.            2.1  Packet Driver Shims for Novell    .................    5
  78.            2.2  Packet Driver Shim for Novell w/Token-RingSNAP   ..    6
  79.            2.3  Packet Driver Shims for Lantastic    ..............    6
  80.               2.3.1  Changes to CONFIG.SYS      ...................    6
  81.               2.3.2  Changes to PROTOCOL.INI      .................    7
  82.            2.4  Packet Driver Shims for Banyan Vines   ............    8
  83.            2.5  Other Things to Configure     .....................    8
  84.  
  85.         CHAPTER 3 - THE WATTCP CONFIGURATION FILE     .............    9
  86.            3.1  Multiple Nodes and the "include" Directive   ......   10
  87.            3.2  Using a BOOTP Server     ..........................   10
  88.            3.3  Manual Configuration       ........................   10
  89.               3.3.1  The PC's Host Name     .......................   11
  90.               3.3.2  The PC's Domain Name     .....................   11
  91.               3.3.3  The PC's IP Address     ......................   11
  92.               3.3.4  The Name Server's IP Address    ..............   12
  93.               3.3.5  The Router's IP Address     ..................   12
  94.               3.3.6  The PC's Network Mask     ....................   12
  95.            3.4  TCP/IP Parameters (optional)      .................   12
  96.               3.4.1  Timeouts        ..............................   13
  97.               3.4.2  Maximum Segment Size (MSS)     ...............   13
  98.            3.5  SLIP Operating Parameters      ....................   13
  99.               3.5.1  Dynamic Parameters       .....................   14
  100.               3.5.2  Blocking Access to Certain Sites    ..........   14
  101.               3.5.3  Allowing Access to a Limited Set of Sites ....   15
  102.               3.5.4  Session Time Limit      ......................   15
  103.               3.5.5  Session Reserve Time      ....................   15
  104.               3.5.6  Inactivity Limit       .......................   16
  105.               3.5.7  Minimum Baud Rate      .......................   16
  106.               3.5.8  Operating Hours       ........................   16
  107.               3.5.9  Startup Message       ........................   17
  108.               3.5.10  Minimum Baud Rate Message     ...............   17
  109.               3.5.11  Operating Hours Message      ................   17
  110.               3.5.12  User Session Logging      ...................   17
  111.               3.5.13  SLIP Packet Monitor      ....................   18
  112.               3.5.14  Non-Standard Port/Fossil Break Detect     ...   18
  113.  
  114.  
  115.  
  116.         
  117.  
  118.  
  119.                                 TABLE OF CONTENTS
  120.  
  121.  
  122.               3.5.15  Eliminating the Startup Count-Down     ......   18
  123.               3.5.16  Silencing the BBS console bell    ...........   18
  124.               3.5.17  Disabling the Local Screen     ..............   19
  125.  
  126.         CHAPTER 4 - INSTALLING THE SLIP DOOR COMMAND    ...........   20
  127.            4.1  Command Line Parameters      ......................   20
  128.               4.1.1  The /MAXMINS Parameter      ..................   20
  129.               4.1.2  The /CONFIG Parameter      ...................   20
  130.               4.1.3  KSP-SLIP.EXE Exit Codes      .................   21
  131.               4.1.4  Checking Packet Counts (PKTCOUNT.EXE)     ....   21
  132.  
  133.         CHAPTER 5 - INSTALLING YOUR ACCESS KEY     ................   22
  134.  
  135.         CHAPTER 6 - CUSTOMIZING THE DISPLAY FILES     .............   23
  136.            6.1  PCBoard Display Macros      .......................   23
  137.            6.2  Macros Unique to KSP SLIP    ......................   23
  138.            6.3  Justification and Spacing      ....................   23
  139.               6.3.1  No Justification       .......................   24
  140.               6.3.2  Left Justification       .....................   24
  141.               6.3.3  Center Justification       ...................   24
  142.               6.3.4  Right Justification       ....................   24
  143.            6.4  The DISPLAY Program      ..........................   25
  144.  
  145.         APPENDIX 1 - HOW TO REACH US     ..........................   26
  146.  
  147.         APPENDIX 2 - GETTING UPDATES VIA THE INTERNET    ..........   27
  148.  
  149.         APPENDIX 3 - LEGAL STUFF       ............................   28
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.         
  175.  
  176.  
  177.  
  178.         Feb 20, 1996           KSP SLIP (tm) v3.4                       1
  179.  
  180.  
  181.                         CHAPTER 1 - INTRODUCTION        
  182.  
  183.  
  184.         Many  BBS's  now offer E-Mail access to the Internet.  But few if
  185.         any  offer  a real TCP/IP connection.  As compared to mere E-Mail
  186.         access,  providing a TCP/IP connection opens up a large number of
  187.         new  possibilities  to  callers,  such  as  the ability to remote
  188.         login  to Internet hosts in foreign countries using Telnet, or to
  189.         access  files  on  those  hosts  using  FTP,  or  to  search  for
  190.         information   using   Gopher,  Archie,  and  the  new  multimedia
  191.         hypertext browser, Mosaic.  
  192.  
  193.         KSP  SLIP  establishes  a  logical two-way connection between the
  194.         user's serial line and the Internet: 
  195.  
  196.                             +----------+     |
  197.                User's       |          |     | Local Area Network
  198.                Modem <----->| KSP SLIP |<----+ connected to the
  199.                             |          |     | Internet
  200.                             +----------+     |
  201.                             BBS Machine
  202.  
  203.         As  indicated,  the  physical  connection between the BBS machine
  204.         and  the  Internet  is  usually  by  means  of  an  Ethernet card
  205.         attached  to  a  local  area  network  that  is  attached  to the
  206.         Internet.   However,  this  connection  could instead be simply a
  207.         separate   modem  connection  to  a  commercial  Internet  access
  208.         provider, such as NETCOM.  
  209.  
  210.         TCP/IP  encapsulates  data in packets and transfers those packets
  211.         according  to  a  specific  communication  protocol.  Data on the
  212.         serial  line  between  the  BBS  and  the  caller  must obey this
  213.         protocol;  KSP  SLIP  does  this  using a popular protocol called
  214.         SLIP  (Serial Link Internet Protocol).  Of course the caller must
  215.         also  be using software at his end that also supports SLIP; there
  216.         are  several  shareware products for this purpose, available from
  217.         the Key Software Products BBS.  
  218.  
  219.         KSP SLIP meets the following BBS-specific needs: 
  220.  
  221.              1.  Terminates  the  BBS session when user's time limit
  222.                      expires.  
  223.              2.  Terminates the BBS session when user hangs up.  
  224.              3.  Terminates   when   there's   no   activity  for  a
  225.                      sysop-specified period of time.  
  226.              4.  Records the SLIP session in a log file.  
  227.              5.  Provide  colorized  or  parameterized  messages  to
  228.                      user.  
  229.  
  230.  
  231.  
  232.  
  233.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  234.  
  235.  
  236.         Feb 20, 1996           KSP SLIP (tm) v3.4                       2
  237.  
  238.  
  239.              6.  Restrict users by baud rate.  
  240.              7.  Restrict hours of operation.  
  241.  
  242.         KSP   SLIP   is  shareware.   The  unlicensed  version  is  fully
  243.         functional  except  that it imposes a maximum of five minutes per
  244.         SLIP  session.   Once  licensed,  the user is limited only by the
  245.         amount of time remaining in his BBS session.  
  246.  
  247.         KSP  SLIP  was  implemented  using  Erick  Engelke's Waterloo TCP
  248.         library,  MarshallSoft  Computing's PCL4C Personal Communications
  249.         library,   and  Mix  Software's  Power  C  compiler  and  Multi-C
  250.         multi-threaded code library.  
  251.  
  252.  
  253.         1.1 Compatibility with BBS Software      
  254.  
  255.         KSP  SLIP is compatible with any BBS software that can generate a
  256.         DOOR.SYS  file.   It  works  with  a  BBS  configured  to use the
  257.         standard  COM1  through  COM4 ports, or will automatically detect
  258.         and use a Fossil driver.  
  259.  
  260.  
  261.         1.2 Hardware Requirements        
  262.  
  263.         KSP  SLIP  inherently  requires  that  the  PC  running  your BBS
  264.         software  have  a  physical  connection  to  a  TCP/IP  network -
  265.         normally  the  Internet.  Ideally, this connection is by means of
  266.         an  adapter  card  connected  to  an  Ethernet at your company or
  267.         school (and then through a "gateway" to the Internet).  
  268.  
  269.         It  is  also  possible  to  connect  to  the  Internet  through a
  270.         commercial  Internet  Access  Provier  via a dial-up SLIP (Serial
  271.         Line  Internet  Protocol)  connection.   This approach requires a
  272.         second  serial  port, modem, and telephone line dedicated to this
  273.         purpose.   Information on finding such a provider is available on
  274.         the KSP BBS.  
  275.  
  276.  
  277.         1.3 Software Requirements        
  278.  
  279.         KSP  SLIP  runs  on  top  of  another  piece of software called a
  280.         "packet  driver".  The packet driver presents a standard software
  281.         interface  to  KSP  SLIP,  regardless  of  the  type  of hardware
  282.         interface  that  connects  the  PC to the network.  Public domain
  283.         packet drivers exist for SLIP links and most Ethernet cards.  
  284.  
  285.         If  your  BBS  uses  a  multi-tasking  operating  system  to  run
  286.         multiple  nodes  on  a  single  PC,  then you will need a "packet
  287.         multiplexer".   A  packet  multiplexer  designed specifically for
  288.  
  289.  
  290.  
  291.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  292.  
  293.  
  294.         Feb 20, 1996           KSP SLIP (tm) v3.4                       3
  295.  
  296.  
  297.         use   with   KSP  network  products  running  under  DESQview  is
  298.         available  as  a  freeware  package  distributed  as KSPMUX*.ZIP,
  299.         where  the  "*"  is  the  version  number.   KSP SLIP is DESQview
  300.         "aware"   to   provide   better  performance  in  a  multitasking
  301.         environment.  
  302.  
  303.         If  your  PC  is  connected  to  a non-TCP/IP proprietary network
  304.         (such  as  Novell  or Lantastic), you will probably need a packet
  305.         driver "shim".  
  306.  
  307.         KSP  SLIP  does  NOT  require that you purchase a separate TCP/IP
  308.         package,  such  as  that  sold  by Novell, Artisoft, or IBM.  KSP
  309.         SLIP   should   happily  coexist  with  any  of  these  packages,
  310.         however.  
  311.  
  312.         An  assortment of public domain packet drivers, multiplexers, and
  313.         shims are available on the KSP BBS.  
  314.  
  315.  
  316.         1.4 Other KSP Software       
  317.  
  318.         Key  Software  Products  offers  a  number  of other products for
  319.         BBS's: 
  320.  
  321.  
  322.         1.4.1 KSP Telnet        
  323.  
  324.         A   door  program  that  allows  callers  to  connect  to  remote
  325.         computers  anywhere  on the Internet via your BBS.  Available now
  326.         on our BBS.  
  327.  
  328.  
  329.         1.4.2 KSP FTP        
  330.  
  331.         A  door  program  that  allows  callers to transfer files to/from
  332.         remote computers anywhere on the Internet via your BBS.  
  333.  
  334.  
  335.         1.4.3 KSP Mail        
  336.  
  337.         A  Multi-Threaded  Server  for  SMTP  Mail  and NNTP Usenet news.
  338.         Replaces  UUCP,  its  monthly  fees,  and slow transfer rates! No
  339.         more  unwanted  newsgroups!  Instant  mail  without  waiting  for
  340.         scheduled  events!   Works  with  any BBS software that presently
  341.         uses  UUCP.   Requires a 24hr TCP/IP Internet connection. Can now
  342.         receive NNTP news feeds! 
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  350.  
  351.  
  352.         Feb 20, 1996           KSP SLIP (tm) v3.4                       4
  353.  
  354.  
  355.         1.4.4 KSP HOST        
  356.  
  357.         An  inbound  Telnet  server  for  MS/DOS  Bulletin Board Systems.
  358.         Every  node  can  answer both telnet and modem calls!  Requires a
  359.         fossil  driver  on  each node, a 24 hour TCP/IP connection to the
  360.         Internet,  and a local area network that supports NetBios such as
  361.         Novell or Lantastic.  
  362.  
  363.  
  364.         1.4.5 So Many CD's       
  365.  
  366.         A  PCBoard PPE to handle off-line CD-Roms.  Seamlessly integrated
  367.         into  PCBoard.   Users  post requests for off-line files and have
  368.         then  returned  as  attachments to messages. Configurable message
  369.         pack-out  dates  automatically  keep  your hard disk from getting
  370.         cluttered.  Available now on our BBS.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  408.  
  409.  
  410.         Feb 20, 1996           KSP SLIP (tm) v3.4                       5
  411.  
  412.  
  413.                         CHAPTER 2 - INSTALLATION        
  414.  
  415.  
  416.         Before  installing  KSP  SLIP  as  a  BBS  door,  you  must first
  417.         install: 
  418.  
  419.              1.  The network interface hardware.  
  420.              2.  A corresponding packet driver.  
  421.              3.  A packet driver shim (if needed).  
  422.              4.  A packet multiplexer (if needed).  
  423.  
  424.         Detailed  directions for these preliminary steps are available in
  425.         separate   documentation   that   comes  with  the  corresponding
  426.         hardware or software.   
  427.  
  428.         It's  most  common  that multi-node BBS's are interconnected with
  429.         Ethernet  and  either  Lantastic or Novell.  Unfortunately, these
  430.         two  network  operating  systems  were  designed  using their own
  431.         proprietary  protocols  rather than the TCP/IP protocol and their
  432.         own  proprietary  software  rather than packet drivers to talk to
  433.         their  Ethernet  interface  cards.   However, a piece of software
  434.         called  a packet driver "shim" can be used to let both TCP/IP and
  435.         their proprietary protocol coexist.  
  436.  
  437.  
  438.         2.1 Packet Driver Shims for Novell     
  439.  
  440.         Novell's  network  software is installed in layers as TSRs in the
  441.         order  shown  below.   These commands are usually found either in
  442.         the  AUTOEXEC.BAT  file  or  in another batch file in a directory
  443.         typically called C:\NWCLIENT.  
  444.  
  445.              LSL
  446.              NE2000  }-- specific to your interface card
  447.              IPXODI
  448.              VLM
  449.  
  450.         The  packet driver shim (ODIPKT) logically sits on top of IPXODI,
  451.         providing  a  packet  driver  interface  for software such as KSP
  452.         SLIP: 
  453.  
  454.              LSL
  455.              NE2000 +--- Frame Type (0-3)
  456.              IPXODI |
  457.              ODIPKT 2 97  }--- The packet driver shim
  458.              VLM       |
  459.                        +----- Packet Vector Interrupt (96-127)
  460.                               (See comment below about hex vs. decimal)
  461.  
  462.  
  463.  
  464.  
  465.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  466.  
  467.  
  468.         Feb 20, 1996           KSP SLIP (tm) v3.4                       6
  469.  
  470.  
  471.         The  ODIPKT  command  line parameters may vary according to which
  472.         version  of  the  software  you  have  and  how  your hardware is
  473.         configured.   The "Frame Type" parameter should correspond to the
  474.         position  of  ETHERNET_II  among  the  frame  types  specified in
  475.         NET.CFG;  zero  (0)  selects  the  first  frame type, one (1) the
  476.         second,  and  so  on. The "Packet Vector Interrupt" number should
  477.         correspond  to  an  unused  interrupt  vector.   Note  that older
  478.         versions  of  ODIPKT  insist that this number be given in decimal
  479.         (96-127)  rather  than  in hex (0x60-0x7F).  The necessary packet
  480.         driver  shim can be downloaded from the Key Software Products BBS
  481.         as file ODI-SHIM.ZIP.   
  482.  
  483.  
  484.         2.2 Packet Driver Shim for Novell w/Token-RingSNAP    
  485.  
  486.         Another  shim  called  ODITRPKT  exists for Novell that should be
  487.         used  if the underlying network is Token-Ring_SNAP.  Installation
  488.         is  similar  to  ODIPKT as described above, except that the first
  489.         command  line  parameter  must  correspond to the Token-Ring_SNAP
  490.         frame  type  in NET.CFG, and starts at "1" rather than "0".  This
  491.         shim  can  be  downloaded  from  the Key Software Products BBS as
  492.         file TKN-SHIM.ZIP.  
  493.  
  494.  
  495.         2.3 Packet Driver Shims for Lantastic     
  496.  
  497.         Using   a   packet  driver  shim  with  Lantastic  requires  that
  498.         Lantastic  be  installed  using  NDIS  (Network  Driver Interface
  499.         Specification)  Support.  The necessary packet driver shim can be
  500.         downloaded   from   the   Key   Software  Products  BBS  as  file
  501.         DIS-SHIM.ZIP.  
  502.  
  503.         NDIS   allows  you  to  stack  multiple  protocols  on  a  single
  504.         adapter.   This  lets  you use multiple protocol drivers (such as
  505.         LANtastic  and  TCP/IP)  on  the  same adapter.  You can also use
  506.         NDIS  to  include  third-party adapters that have NDIS drivers in
  507.         your   LANtastic   network.    Supported  adapter  types  include
  508.         Ethernet,  Token-Ring  and ARCNET (R) adapters.  The software and
  509.         documentation  necessary  to  add  NDIS  support  to  an existing
  510.         Lantastic network is available free of charge from Artisoft.  
  511.  
  512.         Once  you  have NDIS installed and working with Lantastic, adding
  513.         the  shim is a simple matter of editing PROTOCOL.INI (part of the
  514.         NDIS support) and CONFIG.SYS.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  524.  
  525.  
  526.         Feb 20, 1996           KSP SLIP (tm) v3.4                       7
  527.  
  528.  
  529.         2.3.1 Changes to CONFIG.SYS       
  530.  
  531.         With  NDIS  installed,  there  will be two device driver lines in
  532.         your CONFIG.SYS file that look something like the following: 
  533.  
  534.              DEVICE=C:\LANTASTI\PROTMAN.DOS /I:C:\LANTASTI
  535.              DEVICE=C:\LANTASTI\AEXNDIS.DOS
  536.  
  537.         The  file  listed  in  the  second line may differ if you are not
  538.         using  Artisoft's  interface  card; in that case, this file would
  539.         typically  be  replaced  by  a  NDIS  driver supplied by the card
  540.         manufacturer.  
  541.  
  542.         The  packet  driver  shim  itself  is installed as a third device
  543.         driver after the first two, as in: 
  544.  
  545.              DEVICE=C:\LANTASTI\PROTMAN.DOS /I:C:\LANTASTI
  546.              DEVICE=C:\LANTASTI\AEXNDIS.DOS
  547.              DEVICE=C:\DRIVERS\DIS_PKT.DOS  }--- The packet driver shim
  548.  
  549.  
  550.         2.3.2 Changes to PROTOCOL.INI       
  551.  
  552.         The  PROTOCOL.INI  file  is  a  text file created (usually in the
  553.         C:\LANTASTI  directory) as part of the NDIS installation.  Before
  554.         adding  the  packet  driver  shim,  it  typically  looks like the
  555.         following,  but  with  the  "iobase"  and  "interrupt" parameters
  556.         changed   according   to   your  hardware,  or  with  the  entire
  557.         "[AEXNDIS_NIF]"   section  replaced  if  you  are  not  using  an
  558.         Artisoft interface card.  
  559.  
  560.              [PROTMAN]
  561.                DRIVERNAME = PROTMAN$
  562.                DYNAMIC = YES
  563.  
  564.              [AEXNDIS_NIF]
  565.                DRIVERNAME = AEXNDS$
  566.                IOBASE = 0x300
  567.                INTERRUPT = 15
  568.  
  569.         Adding  the packet driver shim requires adding another section to
  570.         the PROTOCOL.INI file: 
  571.  
  572.              [PROTMAN]
  573.                DRIVERNAME = PROTMAN$
  574.                DYNAMIC = YES
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  582.  
  583.  
  584.         Feb 20, 1996           KSP SLIP (tm) v3.4                       8
  585.  
  586.  
  587.              [AEXNDIS_NIF]               <---+
  588.                DRIVERNAME = AEXNDS$          |
  589.                IOBASE = 0x300                |
  590.                INTERRUPT = 15                | These names must match!
  591.                                              |
  592.              [PKTDRV]                        |
  593.                DRIVERNAME = PKTDRV$          |
  594.                BINDINGS = AEXNDIS_NIF    <---+
  595.                INTVEC = 0x61
  596.                CHAINVEC = 0x66
  597.                NOVELL = Y
  598.  
  599.         Note  that the name "AEXNDIS_NIF" must exactly match the spelling
  600.         used  as  the  title of the previous section, "[AEXNDIS_NIF]"; if
  601.         you  are not using Artisoft interface cards, then both occurences
  602.         will  use  some  other identifier.  The "INTVEC" parameter may be
  603.         anything  from  0x60  to 0x80; you may have to experiment to find
  604.         an unused interrupt number.  
  605.  
  606.  
  607.         2.4 Packet Driver Shims for Banyan Vines    
  608.  
  609.         Although  Key  Software  Products  has  never  used  it, and thus
  610.         cannot  offer help on its installation, a packet driver shim does
  611.         exist  for  Banyan  Vines  and  can  be  downloaded  from the Key
  612.         Software Products BBS as file BAN-SHIM.ZIP.  
  613.  
  614.  
  615.         2.5 Other Things to Configure      
  616.  
  617.         Once  your  network  is  up and running with a packet driver or a
  618.         packet driver shim, there are basically two additional steps: 
  619.  
  620.              1.  Create a WATTCP.CFG configuration file.  
  621.              2.  Configure KSP SLIP as a BBS door.  
  622.  
  623.         As  discussed  in the next chapter, you may not need a WATTCP.CFG
  624.         configuration file if you have a BOOTP server.  
  625.  
  626.         There  is  a  useful  program called TCPINFO available on the KSP
  627.         BBS.   If  you have no WATTCP.CFG file, it will tell you (after a
  628.         maximum  of 30 seconds) if it was able to automatically configure
  629.         itself  via  a  BOOTP  server.  If you have a WATTCP.CFG file, it
  630.         will  determine  whether  or  not  you  have configured that file
  631.         properly.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  640.  
  641.  
  642.         Feb 20, 1996           KSP SLIP (tm) v3.4                       9
  643.  
  644.  
  645.                  CHAPTER 3 - THE WATTCP CONFIGURATION FILE     
  646.  
  647.  
  648.         In  order  to  run, KSP SLIP needs to know some information about
  649.         your  network,  and  tries  to  find this in a configuration file
  650.         called  WATTCP.CFG.   KSP  SLIP  looks  in  three  directories to
  651.         locate  this  file.  First, it checks for an environment variable
  652.         called  WATTCP.CFG  that  specifies  the  directory.   Second, it
  653.         looks  in  the  current (default) directory.  Third, if still not
  654.         found,  it  looks  in  the directory that contains the executable
  655.         (KSP-SLIP.EXE).  
  656.  
  657.         The  following  example  may  be  helpful  for  those  using  the
  658.         environment  variable  approach:  If you place WATTCP.CFG in your
  659.         PCB  directory,  then  your  AUTOEXEC.BAT file should contain the
  660.         following command: 
  661.  
  662.                               set WATTCP.CFG=C:\PCB
  663.  
  664.           Note that there is no trailing "\" after the directory name!
  665.  
  666.         If  KSP  SLIP  still  can't  find the configuration file, it will
  667.         attempt  to  automatically  configure  itself  by  looking  for a
  668.         "BOOTP"  server  on  your network.  (BOOTP is a standard protocol
  669.         that  obtains  your "IP address" and other information about your
  670.         PC  from  a  BOOTP  server.)   If there is no BOOTP server, or if
  671.         your  PC  is not registered in its database, then you must create
  672.         a configuration file.  
  673.  
  674.         The  configuration  file  contains  one entry per line.  A sample
  675.         configuration  file  is  included  in  this distribution, but the
  676.         values  MUST  be  modified to suit your particular environment or
  677.         else KSP SLIP will not work!   
  678.  
  679.         The syntax of every entry follows the following format: 
  680.  
  681.            [ directive = [ "data" | data] ] [ # comment | ; comment ]
  682.  
  683.         I.e.,  if  a  directive is not followed by data, the directive is
  684.         ignored.   Similary,  lines  without directives are ignored.  The
  685.         directive is NOT case sensitive; the data IS case sensitive.   
  686.  
  687.         e.g.,   netmask=255.255.252.0
  688.                 domainslist=ksp.com    ; Our domain
  689.  
  690.         Whitespace  is normally removed from data; data containing blanks
  691.         must  be  surrounded by quotes.  An unquoted '#' or ';' marks the
  692.         beginning of a comment.  
  693.  
  694.  
  695.  
  696.  
  697.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  698.  
  699.  
  700.         Feb 20, 1996           KSP SLIP (tm) v3.4                      10
  701.  
  702.  
  703.  
  704.         3.1 Multiple Nodes and the "include" Directive    
  705.  
  706.         There  must  be  one WATTCP.CFG file for each BBS node since each
  707.         node  has  to  be  configured  with  a  unique  hostname  and  IP
  708.         address.   All  other configuration parameters are usually set at
  709.         the  same  values  for  all nodes.  Rather than duplicating these
  710.         common  entries  in each WATTCP.CFG file, you can set-up a master
  711.         configuration   file   that   gets  "included"  in  each  of  the
  712.         node-specific   files.    For  example,  the  node-specific  file
  713.         (WATTCP.CFG) might look like: 
  714.  
  715.                 include=c:\ksp\master.cfg
  716.                 hostname=ourbbspc
  717.                 myip=125.283.210.17
  718.  
  719.         This  makes it much easier to make changes since you only have to
  720.         modify a single file (MASTER.CFG).  
  721.  
  722.  
  723.         3.2 Using a BOOTP Server      
  724.  
  725.         It's  always  a good idea to have a configuration file whether or
  726.         not   you   use   a  BOOTP  server.   If  you  choose  to  use  a
  727.         configuration  file  and want to tell it to use the BOOTP server,
  728.         this  option  allows  you  to specify your the IP address of your
  729.         BOOTP server.  
  730.  
  731.  
  732.                 Example: bootp=129.255.0.128 
  733.  
  734.         You  should  specify the domain name manually as described in the
  735.         next  section  since  the  BOOTP  protocol  doesn't  provide that
  736.         information.  
  737.  
  738.                 Example: domainslist=ksp.com 
  739.  
  740.         NOTE:  An  "IP  address"  is  a logical addressing scheme used on
  741.         TCP/IP  networks  such  as the Internet.  Each computer connected
  742.         to  the  Internet  is  assigned  a unique IP address.  Your local
  743.         network  "guru"  or access provider should be able to provide you
  744.         with those IP addresses you need.   
  745.  
  746.         IMPORTANT:  The  IP  addresses  given  in  this document are only
  747.         examples.   Do  NOT  attempt to use them - they will NOT work and
  748.         your network administrator will probably get VERY upset! 
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  756.  
  757.  
  758.         Feb 20, 1996           KSP SLIP (tm) v3.4                      11
  759.  
  760.  
  761.         3.3 Manual Configuration        
  762.  
  763.         If  you  don't  have  a  BOOTP  server,  or  if  your  PC  is not
  764.         registered  with  a BOOTP server, then you must use the following
  765.         directives   to   configure   KSP  SLIP.   The  values  of  these
  766.         parameters   are  important,  and  KSP  SLIP  will  NOT  function
  767.         properly  without  the  proper  values.   If you are not familiar
  768.         with  the terminology, or if you are unsure of the proper values,
  769.         please consult with your network access provider.  
  770.  
  771.  
  772.         3.3.1 The PC's Host Name      
  773.  
  774.         This  is  the network name of the PC that runs your BBS (and thus
  775.         KSP  SLIP).   If  your  BBS  is implemented by a network of PC's,
  776.         then each PC should have its own unique host name.  
  777.  
  778.                 Example: hostname=bbs 
  779.  
  780.         Note  that  the  host  name  does  not  include  the  domain name
  781.         suffix.   For  example, the hostname of machine '"bbs.ksp.com" is
  782.         simply "bbs".  
  783.  
  784.  
  785.         3.3.2 The PC's Domain Name      
  786.  
  787.         This  is  the  network  name  of the subnet to which your PC (and
  788.         possibly others) are connected.  
  789.  
  790.                 Example: domainslist=ksp.com 
  791.  
  792.         Note  that  the  domain  name  does  not  include  the  host name
  793.         prefix.   For  example, the domain name of machine '"bbs.ksp.com"
  794.         is "ksp.com".  
  795.  
  796.  
  797.         3.3.3 The PC's IP Address      
  798.  
  799.         This is the unique IP address assigned to your PC.  
  800.  
  801.                 Example: my_ip=100.2.37.4  
  802.  
  803.         Your  local  network  "guru" or access provider should be able to
  804.         provide  you  with  the  proper IP address of your PC.  Note that
  805.         you  should  have  a  different  IP address for each node in your
  806.         BBS.  
  807.  
  808.         Note:  As  an  alternative, you may also set the IP address using
  809.         an environment variable, as in: 
  810.  
  811.  
  812.  
  813.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  814.  
  815.  
  816.         Feb 20, 1996           KSP SLIP (tm) v3.4                      12
  817.  
  818.  
  819.  
  820.                               set ksp-ip=100.2.37.4
  821.  
  822.  
  823.         3.3.4 The Name Server's IP Address     
  824.  
  825.         This  is  the  unique  IP  address  assigned  to  a  network name
  826.         nerver.   You  may  specify more than on nameserver by using more
  827.         than one "nameserver" line.  
  828.  
  829.                 Example: nameserver=111.21.108.110 
  830.  
  831.         Your  local  network  "guru" or access provider should be able to
  832.         provide  you  with the proper IP addresses of appropriate network
  833.         name servers.  
  834.  
  835.  
  836.         3.3.5 The Router's IP Address      
  837.  
  838.         This is the unique IP address assigned to the network router.  
  839.  
  840.           Syntax: gateway = ipaddr [ , subnet [ , subnet_mask ] ] 
  841.  
  842.                 Examples: gateway=129.97.176.1
  843.                           gateway=129.97.176.2, 129.97.0.0
  844.                           gateway=129.97.176.2, 129.97.0.0, 255.255.0.0
  845.  
  846.         Usually  the  (destination)  subnet  and  subnet mask need not be
  847.         specified,  and  is  used to create a "default".  The other forms
  848.         are  used  to  specify  one or more other gatewaya for particular
  849.         subnets.  
  850.  
  851.         Your  local  network  "guru" or access provider should be able to
  852.         provide you with the proper IP address of the network router.  
  853.  
  854.  
  855.         3.3.6 The PC's Network Mask      
  856.  
  857.         Network  masks  are  used to distinguish destination IP addresses
  858.         that  are  on  the  local  subnet  from those that are not.  This
  859.         option may not be required, depending on your network topology.  
  860.  
  861.                 Example: netmask=255.255.254.0 
  862.  
  863.         Your  local  network  "guru" or access provider should be able to
  864.         provide you with the proper netmask if needed.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  872.  
  873.  
  874.         Feb 20, 1996           KSP SLIP (tm) v3.4                      13
  875.  
  876.  
  877.         3.4 TCP/IP Parameters (optional)       
  878.  
  879.         KSP  SLIP  will  work without using the following parameters, but
  880.         they are provided if you wish to change them.  
  881.  
  882.  
  883.         3.4.1 Timeouts         
  884.  
  885.         Most  network  operations (such as establishing a connection to a
  886.         remote  host)  have a maximum time before a timeout error occurs.
  887.         The  default  value is 30 seconds; a smaller value is unwise, but
  888.         larger   values   may   be   necessary   for   particularly   bad
  889.         connections.  
  890.  
  891.                 Example: sockdelay=40 
  892.  
  893.  
  894.         3.4.2 Maximum Segment Size (MSS)      
  895.  
  896.         The  default  value  of  MSS  is  1400.  If you know what maximum
  897.         segment  size  means  and know what size you want, you can change
  898.         it: 
  899.  
  900.                 Example: mss=512 
  901.  
  902.                 Note:  Some  Internet  access  providers  configure their
  903.                 dial-up  slip  and ppp accounts with a very small segment
  904.                 size.   You  may  need  to  set mss as low as 212 if your
  905.                 Internet connection is through such a connection.  
  906.  
  907.  
  908.         3.5 SLIP Operating Parameters       
  909.  
  910.         The  remaining  parameters in WATTCP.CFG are operating parameters
  911.         for  KSP  SLIP  that define limits and display files needed while
  912.         KSP SLIP is running.  Each follows the format: 
  913.  
  914.                 ksp-slip.<parameter>=<value> 
  915.  
  916.         where   <parameter>  and  <value>  are  replaced  by  appropriate
  917.         strings.  
  918.  
  919.         Some  operating  parameters have counterparts in other members of
  920.         the  KSP  family  of  network  application programs.  Rather than
  921.         have   multiple   entries   in   the  WATTCP.CFG  file  for  each
  922.         application,  such parameters can be specified globally using the
  923.         format: 
  924.  
  925.                 ksp.<parameter>=<value> 
  926.  
  927.  
  928.  
  929.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  930.  
  931.  
  932.         Feb 20, 1996           KSP SLIP (tm) v3.4                      14
  933.  
  934.  
  935.  
  936.         This  global setting can be overridden for a specific application
  937.         by  using  the  application-specific form at a subsequent line in
  938.         WATTCP.CFG.  
  939.  
  940.  
  941.         3.5.1 Dynamic Parameters        
  942.  
  943.         Configuration  file  parameters  can  be  made  "dynamic".   Such
  944.         parameters  are ignored unless activated by an associated command
  945.         line option: 
  946.  
  947.                 /CONFIG=<number> 
  948.  
  949.         where  "<number>"  is  a non-zero integer.  Dynamic configuration
  950.         parameters  are  those that specify a number in square backets as
  951.         in: 
  952.  
  953.                 ksp-slip[<number>].<parameter>=<value> 
  954.  
  955.         The  number  specified  in the configuration parameter must match
  956.         that  in  the  command  line  option  or  else  the configuration
  957.         parameter will be ignored.  
  958.  
  959.         This also works for dynamic global parameters of the form: 
  960.  
  961.                 ksp[<number>].<parameter>=<value> 
  962.  
  963.  
  964.         3.5.2 Blocking Access to Certain Sites     
  965.  
  966.          Syntax: ksp-slip.blocked_ip_list=<pathspec> 
  967.  
  968.         Example: ksp-slip.blocked_ip_list=c:\ksp\blocked.lst 
  969.  
  970.         Purpose: Specifies  the  name of a text file containing a list of
  971.                  blocked  IP  addresses.  No user access to sites on this
  972.                  list will be allowed.  
  973.  
  974.            Note: Packets  addressed  to  blocked  IP  addresses  are  not
  975.                  forwarded  to  their  destination; however KSP-SLIP does
  976.                  return  a  type 3 ("host unreachable") ICMP error packet
  977.                  to  the  caller's slip client software, with explanation
  978.                  code   10   ("communication  with  destination  host  is
  979.                  administratively  forbidden").   Although  the  caller's
  980.                  client   software  may  present  a  corresponding  error
  981.                  message  to  the  user,  some  (such as Trumpet Winsock)
  982.                  will  simply  ignore  such  ICMP packets.  In the latter
  983.                  case,  the  user  may  not  understand  why  there's  no
  984.  
  985.  
  986.  
  987.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  988.  
  989.  
  990.         Feb 20, 1996           KSP SLIP (tm) v3.4                      15
  991.  
  992.  
  993.                  response   from   the   remote   host,   and  thus  some
  994.                  explanation  (such  as  a  posted  bulletin)  should  be
  995.                  provided on the BBS.  
  996.  
  997.  
  998.         3.5.3 Allowing Access to a Limited Set of Sites  
  999.  
  1000.          Syntax: ksp-slip.allowed_ip_list=<pathspec> 
  1001.  
  1002.         Example: ksp-slip.allowed_ip_list=c:\ksp\allowed.lst 
  1003.  
  1004.         Purpose: Specifies  the  name of a text file containing a list of
  1005.                  IP   addresses   to  which  the  users  are  allowed  to
  1006.                  connect.   No user access to sites not on this list will
  1007.                  be allowed.  
  1008.  
  1009.            Note: Packets   addressed   to  other  IP  addresses  are  not
  1010.                  forwarded  to  their  destination; however KSP-SLIP does
  1011.                  return  a  type 3 ("host unreachable") ICMP error packet
  1012.                  to  the  caller's slip client software, with explanation
  1013.                  code   10   ("communication  with  destination  host  is
  1014.                  administratively  forbidden").   Although  the  caller's
  1015.                  client   software  may  present  a  corresponding  error
  1016.                  message  to  the  user,  some  (such as Trumpet Winsock)
  1017.                  will  simply  ignore  such  ICMP packets.  In the latter
  1018.                  case,  the  user  may  not  understand  why  there's  no
  1019.                  response   from   the   remote   host,   and  thus  some
  1020.                  explanation  (such  as  a  posted  bulletin)  should  be
  1021.                  provided on the BBS.  
  1022.  
  1023.  
  1024.         3.5.4 Session Time Limit       
  1025.  
  1026.          Syntax: ksp-slip.max_mins=<number> 
  1027.  
  1028.         Example: ksp-slip.max_mins=30 
  1029.  
  1030.         Purpose: Overrides  the  time  remaining as specified in DOOR.SYS
  1031.                  if  lower.  If omitted, time remaining is that specified
  1032.                  by DOOR.SYS.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1046.  
  1047.  
  1048.         Feb 20, 1996           KSP SLIP (tm) v3.4                      16
  1049.  
  1050.  
  1051.         3.5.5 Session Reserve Time       
  1052.  
  1053.          Syntax: ksp-slip.reserve_mins=<number> 
  1054.  
  1055.         Example: ksp-slip.reserve_mins=3 
  1056.  
  1057.         Purpose: Reduces  the  time available in the door so that if time
  1058.                  runs  out,  the  user  still  has a small amount of time
  1059.                  left  on  the BBS.  This is useful, for example, if your
  1060.                  BBS  offers  a  Time  Bank  so  that users can use it to
  1061.                  withdraw extra time.  
  1062.  
  1063.  
  1064.         3.5.6 Inactivity Limit        
  1065.  
  1066.          Syntax: ksp-slip.idle_mins=<minutes> 
  1067.  
  1068.         Example: ksp-slip.idle_mins=10 
  1069.  
  1070.         Purpose: Establishes  an  upper limit on how long the session can
  1071.                  remain  inactive  before  it is terminated.  If omitted,
  1072.                  no inactivity limit is imposed.  
  1073.  
  1074.  
  1075.         3.5.7 Minimum Baud Rate       
  1076.  
  1077.          Syntax: ksp-slip.minbaud=<baudrate>[,<security>] 
  1078.  
  1079.         Example: ksp-slip.minbaud=9600 
  1080.  
  1081.         Example: ksp-slip.minbaud=9600,100 
  1082.  
  1083.         Purpose: Specifies  a  minimum  baud  rate  required  to  use the
  1084.                  gateway,  and  an  optional  security  level required to
  1085.                  override  the minimum baud rate.  If omitted, no minimum
  1086.                  baud rate will be required.  
  1087.  
  1088.  
  1089.         3.5.8 Operating Hours        
  1090.  
  1091.          Syntax: ksp-slip.ophours=<hh:mm-hh:mm> 
  1092.  
  1093.         Example: ksp-slip.ophours=21:00-23:00 
  1094.  
  1095.         Purpose: To  establish  the  hours  of operation for the gateway;
  1096.                  attempts  to  use  the  gateway  at  other times will be
  1097.                  disallowed.    Times   must  be  specified  in  24  hour
  1098.                  format.   If  omitted,  the  gateway  may be used at any
  1099.                  time.  
  1100.  
  1101.  
  1102.  
  1103.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1104.  
  1105.  
  1106.         Feb 20, 1996           KSP SLIP (tm) v3.4                      17
  1107.  
  1108.  
  1109.  
  1110.         Note: If  start  time  is  after  the  stop  time,  the  hours of
  1111.               operation  will  be  interpreted  as  all  but those in the
  1112.               window  specified.   I.e.,  setting  ophours to 03:20-03:00
  1113.               will allow operation anytime except 03:00-03:20.  
  1114.  
  1115.  
  1116.         3.5.9 Startup Message        
  1117.  
  1118.          Syntax: ksp-slip.startup_msg=<filespec> 
  1119.  
  1120.         Example: ksp-slip.startup_msg=c:\ksp-slip\startup.msg 
  1121.  
  1122.         Purpose: Specifies  the  location  of  a display file sent to the
  1123.                  user  when  the  gateway is initialized.  If omitted, no
  1124.                  display file is sent.  
  1125.  
  1126.  
  1127.         3.5.10 Minimum Baud Rate Message      
  1128.  
  1129.          Syntax: ksp-slip.minbaud_msg=<filespec> 
  1130.  
  1131.         Example: ksp-slip.minbaud_msg=c:\ksp-slip\minbaud.msg 
  1132.  
  1133.         Purpose: Specifies  the  location  of  a display file sent to the
  1134.                  user  if the his baud rate is less than that required by
  1135.                  the  "ksp-slip.minbaud"  option (described earlier).  If
  1136.                  omitted, no display file is sent.  
  1137.  
  1138.  
  1139.         3.5.11 Operating Hours Message       
  1140.  
  1141.          Syntax: ksp-slip.ophours_msg=<filespec> 
  1142.  
  1143.         Example: ksp-slip.ophours_msg=c:\ksp-slip\ophours.msg 
  1144.  
  1145.         Purpose: Specifies  the  location  of  a display file sent to the
  1146.                  user  if  the  he  attempts  to use the gateway at other
  1147.                  than  the  hours  specified  by  the  "ksp-slip.ophours"
  1148.                  option  (described  earlier).   If  omitted,  no display
  1149.                  file is sent.  
  1150.  
  1151.  
  1152.         3.5.12 User Session Logging       
  1153.  
  1154.          Syntax: ksp-slip.log_dir=<pathspec> 
  1155.  
  1156.         Example: ksp-slip.log_dir=c:\ksp-slip 
  1157.  
  1158.  
  1159.  
  1160.  
  1161.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1162.  
  1163.  
  1164.         Feb 20, 1996           KSP SLIP (tm) v3.4                      18
  1165.  
  1166.  
  1167.         Purpose: Specifies  the  name  of a directory where a log of user
  1168.                  sessions   will  be  kept.   The  log  files  are  named
  1169.                  KSP-SLIP.???, where "???" is the BBS node number.  
  1170.  
  1171.  
  1172.         3.5.13 SLIP Packet Monitor       
  1173.  
  1174.          Syntax: ksp-slip.status=<method> 
  1175.  
  1176.         Example: ksp-slip.status=direct 
  1177.  
  1178.         Purpose: Enables  local console display of SLIP packet counts and
  1179.                  selects  output method.  Options are "direct" (fastest),
  1180.                  "bios",  and  "ansi"  (slowest).   If  running  under  a
  1181.                  multi-tasker,  you may need to specify "ansi" or "bios";
  1182.                  otherwise use "direct".  
  1183.  
  1184.  
  1185.         3.5.14 Non-Standard Port/Fossil Break Detect      
  1186.  
  1187.          Syntax: ksp-slip.serial_port=<adr>,<irq> 
  1188.  
  1189.         Example: ksp-slip.serial_port=3F8,5 
  1190.  
  1191.         Purpose: Used  to  override serial port and IRQ values implied by
  1192.                  "COMx"    in    DOOR.SYS    to    support   non-standard
  1193.                  configurations  that  are  NOT  using  a  fossil driver.
  1194.                  Also  used  WITH  a  fossil  driver  to add serial break
  1195.                  detection  as  required to return to BBS without hanging
  1196.                  up.  
  1197.  
  1198.                  The  port  address  <adr>  must be specified in hex, and
  1199.                  the   interrupt   request  line  number  <irq>  must  be
  1200.                  specified in decimal.  
  1201.  
  1202.  
  1203.         3.5.15 Eliminating the Startup Count-Down      
  1204.  
  1205.          Syntax: ksp-slip.countdown=<yes|no> 
  1206.  
  1207.         Example: ksp-slip.countdown=no 
  1208.  
  1209.         Purpose: Used  to  eliminate the default "Press any key to begin"
  1210.                  message  and  nine-second countdown at startup.  Default
  1211.                  is 'yes'.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1220.  
  1221.  
  1222.         Feb 20, 1996           KSP SLIP (tm) v3.4                      19
  1223.  
  1224.  
  1225.         3.5.16 Silencing the BBS console bell     
  1226.  
  1227.          Syntax: ksp-slip.local_bell=<option> 
  1228.  
  1229.         Example: ksp-slip.local_bell=disabled 
  1230.  
  1231.         Purpose: Used to silence the bell on the local BBS console.  
  1232.  
  1233.  
  1234.         3.5.17 Disabling the Local Screen      
  1235.  
  1236.          Syntax: ksp-slip.local_screen=<option> 
  1237.  
  1238.         Example: ksp-slip.local_screen=disabled 
  1239.  
  1240.         Purpose: Used  to  disable  painting  of  the local (BBS) screen,
  1241.                  thus  improving  screen  painting  speed for the caller.
  1242.                  This  option  does  not  affect  status  displays on the
  1243.                  local console.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1278.  
  1279.  
  1280.         Feb 20, 1996           KSP SLIP (tm) v3.4                      20
  1281.  
  1282.  
  1283.                 CHAPTER 4 - INSTALLING THE SLIP DOOR COMMAND    
  1284.  
  1285.  
  1286.         Install  KSP  SLIP  as  you  would any other door program on your
  1287.         BBS.   Be  sure  you  setup the BBS to create a DOOR.SYS file for
  1288.         KSP  SLIP  when  it  runs.   (KSP  SLIP  does not need a USER.SYS
  1289.         file.)   If you are running multiple BBS nodes accessing a single
  1290.         copy  of  the  file  KSP-SLIP.EXE, then don't forget to make that
  1291.         file  (and  the  *.MSG  display  files)  read-only  using the DOS
  1292.         ATTRIB command in order to avoid sharing conflicts.  
  1293.  
  1294.         Most  BBS's  use  a  batch  file  to run a door.  For example, on
  1295.         PCBoard  systems you might create a door batch file called "SLIP"
  1296.         containing simply: 
  1297.  
  1298.                 C:\KSP\KSP-SLIP 
  1299.                 BOARD 
  1300.  
  1301.         Do  NOT  change  directories  within  this  batch file!  KSP SLIP
  1302.         expects  to  find  the  DOOR.SYS  file in whatever is the default
  1303.         directory  at  the  moment it starts to run.  That's why the name
  1304.         of  the  program  is preceeded by the name of the directory where
  1305.         it is located.  
  1306.  
  1307.         Of  course, you must also configure your BBS so it knows where to
  1308.         find this batch file (SLIP).  
  1309.  
  1310.  
  1311.         4.1 Command Line Parameters       
  1312.  
  1313.         4.1.1 The /MAXMINS Parameter       
  1314.  
  1315.         The  /MAXMINS  parameter  is an alternative to the same parameter
  1316.         that  appears  in  the  WATTCP.CFG  file.   It  provides  another
  1317.         mechanism  for  limiting  the maximum time a caller is allowed in
  1318.         the door.  The syntax is: 
  1319.  
  1320.                 /MAX_MINS=<minutes> 
  1321.  
  1322.         where "<minutes>" is replaced by a number, as in: 
  1323.  
  1324.                 KSP-SLIP /MAX_MINS=60 
  1325.  
  1326.  
  1327.         4.1.2 The /CONFIG Parameter       
  1328.  
  1329.         The  /CONFIG  parameter  is  used  in  conjunction with "dynamic"
  1330.         configuration  parameters  to  enable  or  disable  them.   For a
  1331.         complete  description  of  this  feature,  please see the section
  1332.  
  1333.  
  1334.  
  1335.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1336.  
  1337.  
  1338.         Feb 20, 1996           KSP SLIP (tm) v3.4                      21
  1339.  
  1340.  
  1341.         called "Dynamic Parameters".  
  1342.  
  1343.  
  1344.         4.1.3 KSP-SLIP.EXE Exit Codes       
  1345.  
  1346.         At  the  end of execution, KSP-SLIP exits with an errorlevel that
  1347.         indicates the reason for termination: 
  1348.  
  1349.                 0       User never got past startup screen 
  1350.                 1       Carrier lost (user hung up) 
  1351.                 2       Break detected (intentionally sent by user) 
  1352.                 3       Inactivity timeout 
  1353.                 4       Session timeout 
  1354.                 255     Some sort of program error condition 
  1355.  
  1356.  
  1357.         4.1.4 Checking Packet Counts (PKTCOUNT.EXE)      
  1358.  
  1359.         At  the  end  of execution, KSP-SLIP writes a one-line ascii text
  1360.         file  containing three numbers.  For example, the line might look
  1361.         like: 
  1362.  
  1363.         1534  1647 35
  1364.           |     |   |
  1365.           |     |   +--- number of bad packets received from user
  1366.           |     +------- number of good packets received from user
  1367.           +------------- number of packets transmitted to user
  1368.  
  1369.         The  content  of  this  file  is  overwritten  each  time you run
  1370.         KSP-SLIP.   A  companion  program  called  PKTCOUNT.EXE  has been
  1371.         provided  to  read  and  exits  with  one of these numbers as its
  1372.         errorlevel  (limited  to  255);  this  program can be used in the
  1373.         batch  file  that  runs the door for various accounting purposes.
  1374.         For  example,  you  may  not  wish  to charge a user if they were
  1375.         having  configuration  problems  with their slip client software,
  1376.         usually  indicated by lots of bad packets received and only a few
  1377.         good ones.  
  1378.  
  1379.         The PKTCOUNT program requires one command line argument: 
  1380.  
  1381.                 PKTCOUNT <option>
  1382.  
  1383.         where  "<option>"  is  one  of "SENT", "GOOD", or "BAD".  Running
  1384.         the  program  with  no command line argument will produce a short
  1385.         usage summary.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1394.  
  1395.  
  1396.         Feb 20, 1996           KSP SLIP (tm) v3.4                      22
  1397.  
  1398.  
  1399.                    CHAPTER 5 - INSTALLING YOUR ACCESS KEY     
  1400.  
  1401.  
  1402.         The  unlicensed version of KSP SLIP limits each user to a maximum
  1403.         of  five  minutes  per  session.   To remove this limit, you must
  1404.         purchase  an  access  key and install it as described below; once
  1405.         installed,  users will be limited only by their time remaining on
  1406.         the BBS.  
  1407.  
  1408.         There  are  three  parameters  that  must  be  specified  in  two
  1409.         environment  variables called "KSP-ID" and "KSP-SLIP" in order to
  1410.         install  your access key; the access key will not be validated if
  1411.         any parameter is missing.  
  1412.  
  1413.         The  environment  variable  "KSP-ID"  is used to specify your BBS
  1414.         name, as in: 
  1415.  
  1416.                       set ksp-id=Key Software Products BBS
  1417.  
  1418.         The  environment  variable  "KSP-SLIP"  is  used  to  specify the
  1419.         number  of BBS nodes and your access key separated by a semicolon
  1420.         as in: 
  1421.  
  1422.                              set ksp-slip=2;12345678
  1423.  
  1424.         The  access  key  is  derived  from  the name of your BBS and the
  1425.         number   of   BBS  nodes.   The  specified  key  must  match  the
  1426.         combination  of BBS name and nodes.  If not, or if you invoke KSP
  1427.         SLIP  on a node whose node number is greater than indicated, then
  1428.         the caller will be limited to five minutes per session.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1452.  
  1453.  
  1454.         Feb 20, 1996           KSP SLIP (tm) v3.4                      23
  1455.  
  1456.  
  1457.                  CHAPTER 6 - CUSTOMIZING THE DISPLAY FILES     
  1458.  
  1459.  
  1460.         The distribution package includes three sample display files: 
  1461.  
  1462.            OPHOURS.MSG     Displayed during off hours
  1463.            STARTUP.MSG     Displayed on start of gateway session
  1464.            LOSPEED.MSG     Displayed if baud rate is too low
  1465.  
  1466.         These   files   have  been  customized  by  the  use  of  certain
  1467.         predefined  "macros".  Some of these macros are a subset of those
  1468.         supported by PCBoard, while others are unique to KSP SLIP.  
  1469.  
  1470.  
  1471.         6.1 PCBoard Display Macros       
  1472.  
  1473.         The  following  PCBoard  display  macros,  plus  all of PCBoard's
  1474.         "@X##"  color control macros, may be used within KSP SLIP display
  1475.         files.   For  a  description of what they represent, refer to the
  1476.         PCBoard documentation.  
  1477.  
  1478.                     @BEEP@          @CLREOL@        @CLS@
  1479.                     @FIRST@         @MINLEFT@       @SECURITY@
  1480.                     @SYSDATE@       @SYSTIME@       @USER@
  1481.                     @POS:#@
  1482.  
  1483.  
  1484.         6.2 Macros Unique to KSP SLIP     
  1485.  
  1486.         The  following  additional display file macros are also supported
  1487.         by KSP SLIP.  
  1488.  
  1489.                 @SLIPIP@                The IP address of the BBS node
  1490.                 @SLIPNAME@              The SLIP node's network name
  1491.                 @DCESPEED@              Current DCE (carrier) speed
  1492.                 @DTESPEED@              Current DTE (PC-Modem) speed
  1493.                 @EXPIRETIME@            Expire time in HH:MM format
  1494.                 @IDLEMINS@              Maximum inactivity time
  1495.                 @MINDCESPEED@           Minimum DCE (carrier) speed
  1496.                 @OPHOURS@               Hours of operation
  1497.                 @OVERRIDE@              Override security for mindcespeed
  1498.  
  1499.  
  1500.         6.3 Justification and Spacing       
  1501.  
  1502.         Any  of  the text insertion macros used in KSP SLIP display files
  1503.         can  appear  in  one  of four forms as discussed in the following
  1504.         paragraphs.    These  options  allow  you  to  precisely  control
  1505.         spacing,  and  allow  you  to  draw a box around a message - even
  1506.  
  1507.  
  1508.  
  1509.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1510.  
  1511.  
  1512.         Feb 20, 1996           KSP SLIP (tm) v3.4                      24
  1513.  
  1514.  
  1515.         when replacement text within a line has a varying length.  
  1516.  
  1517.  
  1518.         6.3.1 No Justification        
  1519.  
  1520.          Syntax: @<keyword>@ 
  1521.  
  1522.         Example: @USER@ 
  1523.  
  1524.         Purpose: Inserts  the  replacment  text, using as many columns as
  1525.                  are necessary.  
  1526.  
  1527.  
  1528.         6.3.2 Left Justification        
  1529.  
  1530.          Syntax: @<keyword>:<number>@ 
  1531.              or: @<keyword>:<number>L@ 
  1532.  
  1533.         Example: @USER:15@ 
  1534.              or: @USER:15L@ 
  1535.  
  1536.         Purpose: Insert  the  replacement text, left justifying it within
  1537.                  a   field   whose  width  is  specified  by  the  number
  1538.                  following  the colon.  If more columns are required than
  1539.                  provided  in  the  field  width,  the field is expanded.
  1540.                  macro.  
  1541.  
  1542.  
  1543.         6.3.3 Center Justification        
  1544.  
  1545.          Syntax: @<keyword>:<number>C@ 
  1546.  
  1547.         Example: @USER:15C@ 
  1548.  
  1549.         Purpose: Insert  the  replacement  text,  centering  it  within a
  1550.                  field  whose  width is specified by the number following
  1551.                  the  colon.   If more columns are required than provided
  1552.                  in the field width, the field is expanded.  
  1553.  
  1554.  
  1555.         6.3.4 Right Justification        
  1556.  
  1557.          Syntax: @<keyword>:<number>R@ 
  1558.  
  1559.         Example: @USER:15R@ 
  1560.  
  1561.         Purpose: Insert  the replacement text, right justifying it within
  1562.                  a   field   whose  width  is  specified  by  the  number
  1563.                  following  the colon.  If more columns are required than
  1564.  
  1565.  
  1566.  
  1567.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1568.  
  1569.  
  1570.         Feb 20, 1996           KSP SLIP (tm) v3.4                      25
  1571.  
  1572.  
  1573.                  provided in the field width, the field is expanded.  
  1574.  
  1575.  
  1576.         6.4 The DISPLAY Program       
  1577.  
  1578.         Included  among  the distribution files is DISPLAY.EXE, a program
  1579.         that  helps  design  a  display  file by allowing it to be viewed
  1580.         offline.  The command line syntax is: 
  1581.  
  1582.                           DISPLAY [-g] [-7] <filespec>
  1583.  
  1584.         Where:  <filespec>   Is the name of the display file.
  1585.                              The filename extension defaults
  1586.                              to ".MSG" if omitted.
  1587.  
  1588.                 []           Denotes an optional argument.
  1589.  
  1590.                 -g           Enables (color) graphics and
  1591.                              ANSI control sequences; requires
  1592.                              ANSI.SYS to be installed.
  1593.                              Default is disabled.
  1594.  
  1595.                 -7           Replaces 8-bit graphics characters
  1596.                              with suitable 7-bit alternatives.
  1597.  
  1598.  
  1599.  
  1600.  
  1601.  
  1602.  
  1603.  
  1604.  
  1605.  
  1606.  
  1607.  
  1608.  
  1609.  
  1610.  
  1611.  
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1626.  
  1627.  
  1628.         Feb 20, 1996           KSP SLIP (tm) v3.4                      26
  1629.  
  1630.  
  1631.                         APPENDIX 1 - HOW TO REACH US     
  1632.  
  1633.  
  1634.         The  Key Software Products BBS/FAX number (415-364-9847) operates
  1635.         24   hours   a   day,  7  days  a  week.   Software  at  our  end
  1636.         automatically  determines whether an incoming call is data or FAX
  1637.         and will operate accordingly.  
  1638.  
  1639.         If  you have access to electronic mail, you can send us a message
  1640.         via any of the following: 
  1641.  
  1642.         On COMPUSERVE, send mail to:
  1643.  
  1644.                 >Internet:tech.support@ksp.com
  1645.  
  1646.         On PRODIGY, send mail to: VGDC59A
  1647.  
  1648.         On Internet, UUCP, or Bitnet, send mail to:
  1649.  
  1650.                 tech.support@ksp.com
  1651.  
  1652.         On Fidonet, address mail to "UUCP" at nearest fidonet site which
  1653.         provides a gateway to Internet, such as 1:105/42.
  1654.  
  1655.                 1st line of message: To: tech.support@ksp.com
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.  
  1662.  
  1663.  
  1664.  
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.  
  1683.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1684.  
  1685.  
  1686.         Feb 20, 1996           KSP SLIP (tm) v3.4                      27
  1687.  
  1688.  
  1689.                 APPENDIX 2 - GETTING UPDATES VIA THE INTERNET    
  1690.  
  1691.  
  1692.         The  main  distribution  file  is KSPSLP??.ZIP, where "??" is the
  1693.         version  number.  You can retrieve this file via anonymous ftp at
  1694.         "scizzl.scu.edu",  directory "ksp".  Please note that there is no
  1695.         "e" at the end of "scizzl".  
  1696.  
  1697.         This  file  is also available from the KSP BBS, either by calling
  1698.         in   and   downloading,   or  via  e-mail  using  the  "LISTSERV"
  1699.         capabilities of the BBS.  
  1700.  
  1701.         To  use  LISTSERV,  you  must  send  a  message  addressed to the
  1702.         Internet  address  listserv@ksp.com.  The message must contain an
  1703.         LISTSERV  command  entered  as a single line of text, and it must
  1704.         be  the first line in the message. The LISTSERV commands that are
  1705.         supported include: 
  1706.  
  1707.         Command: HELP tlbmm-l
  1708.         Purpose: Returns an text file with help information about LISTSERV.
  1709.  
  1710.         Command: DIR tlbmm-l
  1711.         Purpose: Returns an e-mail message listing all of the file 
  1712.                  directories on the BBS by number and description.
  1713.  
  1714.         Command: LIST tlbmm-l 1
  1715.         Purpose: Returns an e-mail message listing all of the files in
  1716.                  directory #1 of the BBS.
  1717.  
  1718.         Command: GET tlbmm-l KSPSLP34.ZIP
  1719.         Purpose: Returns an e-mail message containing a uuencoded version of
  1720.                  the file KSPSLP34.ZIP.  To extract the file, you must save
  1721.                  the message as a file on your system, edit out the e-mail
  1722.                  header at the beginning of the file, and then use a program
  1723.                  called UUDECODE (commonly available on Unix) to convert the
  1724.                  uuencoded version back to the original ZIP format, and then
  1725.                  (finally) use PKUNZIP to extract the contents of the file.
  1726.  
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.  
  1740.  
  1741.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1742.  
  1743.  
  1744.         Feb 20, 1996           KSP SLIP (tm) v3.4                      28
  1745.  
  1746.  
  1747.                          APPENDIX 3 - LEGAL STUFF       
  1748.  
  1749.  
  1750.                                 LIMITED WARRANTY
  1751.  
  1752.         This  software  is provided 'as is' without warranty of any kind,
  1753.         either  expressed  or  implied, including, but not limited to the
  1754.         implied   warranties   of   merchantability  and  fitness  for  a
  1755.         particular  purpose.   The  entire  risk  as  to  the quality and
  1756.         performance of the program is with you.  
  1757.  
  1758.         Some  states do not allow the exclusion of implied warranties, so
  1759.         the  above  exclusions may not apply to you.  This warranty gives
  1760.         you  specific  legal  rights  and  you may also have other rights
  1761.         which vary from state to state.  
  1762.  
  1763.         Key  Software  Products  has  taken  due  care  in  preparing the
  1764.         documentation  and  software  included  in   to  ascertain  their
  1765.         correctness  and  effectiveness.   However, Key Software Products
  1766.         does  not  warrant  that  operation  of  this  software  will  be
  1767.         uninterrupted  or  error  free.   In  no event shall Key Software
  1768.         Products  be  liable  for  incidental or consequential damages in
  1769.         connection  with  or  arising out of the furnishing, performance,
  1770.         or use of this software.  
  1771.  
  1772.  
  1773.                                      LICENSE
  1774.  
  1775.         You  MAY  use  this software on any computer or computers in your
  1776.         possession.   The licensed version is registered for use on up to
  1777.         a  fixed  number of BBS nodes running on multiple machines and/or
  1778.         multiple multi-tasking processes.  
  1779.  
  1780.         You  MAY  copy this software into any machine readable or printed
  1781.         form  for  backup or modification purposes in support of your use
  1782.         of the software.  
  1783.  
  1784.         You  MAY  distribute  the original unmodified, unlicensed version
  1785.         of  this  software,  but you may not charge a fee exceeding $5.00
  1786.         to  cover  the  cost of duplicating, shipping, and handling.  You
  1787.         may NOT distribute a licensed version of this software.  
  1788.  
  1789.         You  may  NOT  use,  copy, modify, sublicense, assign or transfer
  1790.         this  software  and  its license, or any copy or modification, in
  1791.         whole  or  in  part,  except  as  expressly  provided for in this
  1792.         license.  
  1793.  
  1794.  
  1795.  
  1796.  
  1797.  
  1798.  
  1799.         Copyright (C) 1995-96, Key Software Products. All Rights Reserved
  1800.  
  1801.